streamlit-nightly 1.43.3.dev20250317__py3-none-any.whl → 1.43.3.dev20250318__py3-none-any.whl

streamlit/config.py

@@ -22,7 +22,7 @@ import secrets
 import threading
 from collections import OrderedDict
 from enum import Enum
-from typing import Any, Callable
+from typing import Any, Callable, Literal
 
 from blinker import Signal
 
@@ -86,6 +86,12 @@ class ShowErrorDetailsConfigOptions(str, Enum):
         # command-line and bool when set via user script (e.g. st.set_option("client.showErrorDetails", False)).
 
 
+class CustomThemeCategories(str, Enum):
+    """Theme categories that can be set with custom theme config."""
+
+    SIDEBAR = "sidebar"
+
+
 def set_option(key: str, value: Any, where_defined: str = _USER_DEFINED) -> None:
     """Set config option.
 
@@ -293,6 +299,36 @@ def _create_option(
     return option
 
 
+def _create_theme_options(
+    name: str,
+    categories: list[Literal["theme"] | CustomThemeCategories],
+    description: str | None = None,
+    default_val: Any | None = None,
+    visibility: str = "visible",
+    type_: type = str,
+) -> None:
+    """
+    Create ConfigOption(s) for a theme-related config option and store it globally in this module.
+    The same config option can be supported for multiple categories, e.g. "theme" and "theme.sidebar".
+    """
+    for cat in categories:
+        section = cat if cat == "theme" else f"theme.{cat.value}"
+
+        _create_option(
+            f"{section}.{name}",
+            description=description,
+            default_val=default_val,
+            scriptable=False,
+            visibility=visibility,
+            deprecated=False,
+            deprecation_text=None,
+            expiration_date=None,
+            replaced_by=None,
+            type_=type_,
+            sensitive=False,
+        )
+
+
 def _delete_option(key: str) -> None:
     """Remove a ConfigOption by key from the global store.
 
@@ -1004,42 +1040,56 @@ _create_option(
 
 _create_section("theme", "Settings to define a custom theme for your Streamlit app.")
 
-_create_option(
-    "theme.base",
+# Create a section for each custom theme element
+for cat in list(CustomThemeCategories):
+    _create_section(
+        f"theme.{cat.value}",
+        f"Settings to define a custom {cat.value} theme in your Streamlit app.",
+    )
+
+_create_theme_options(
+    "base",
+    categories=["theme"],
     description="""
         The preset Streamlit theme that your custom theme inherits from.
         One of "light" or "dark".
     """,
 )
 
-_create_option(
-    "theme.primaryColor",
+_create_theme_options(
+    "primaryColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Primary accent color for interactive elements.",
 )
 
-_create_option(
-    "theme.backgroundColor",
+_create_theme_options(
+    "backgroundColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Background color for the main content area.",
 )
 
-_create_option(
-    "theme.secondaryBackgroundColor",
+_create_theme_options(
+    "secondaryBackgroundColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Background color used for the sidebar and most interactive widgets.",
 )
 
-_create_option(
-    "theme.textColor",
+_create_theme_options(
+    "textColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Color used for almost all text.",
 )
 
-_create_option(
-    "theme.linkColor",
+_create_theme_options(
+    "linkColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="Color used for all links.",
     visibility="hidden",
 )
 
-_create_option(
-    "theme.font",
+_create_theme_options(
+    "font",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The font family for all text in the app, except code blocks. One of "sans serif",
         "serif", or "monospace".
@@ -1047,8 +1097,9 @@ _create_option(
     """,
 )
 
-_create_option(
-    "theme.codeFont",
+_create_theme_options(
+    "codeFont",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The font family to use for code (monospace) in the app.
         To use a custom font, it needs to be added via [theme.fontFaces].
@@ -1056,8 +1107,9 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "theme.headingFont",
+_create_theme_options(
+    "headingFont",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The font family to use for headings in the app.
         To use a custom font, it needs to be added via [theme.fontFaces].
@@ -1065,17 +1117,18 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "theme.fontFaces",
+_create_theme_options(
+    "fontFaces",
+    categories=["theme"],
     description="""
     Configure a list of font faces that you can use for the app & code fonts.
 """,
     visibility="hidden",
 )
 
-
-_create_option(
-    "theme.baseRadius",
+_create_theme_options(
+    "baseRadius",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The radius used as basis for the corners of most UI elements. Can be:
         "none", "small", "medium", "large", "full", or the number in pixel or rem.
@@ -1084,16 +1137,18 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "theme.borderColor",
+_create_theme_options(
+    "borderColor",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         The color of the border around elements.
     """,
     visibility="hidden",
 )
 
-_create_option(
-    "theme.showBorderAroundInputs",
+_create_theme_options(
+    "showBorderAroundInputs",
+    categories=["theme", CustomThemeCategories.SIDEBAR],
     description="""
         Whether to show a border around input elements (e.g. text_input, number_input,
         file_uploader, etc).
@@ -1102,8 +1157,9 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "theme.baseFontSize",
+_create_theme_options(
+    "baseFontSize",
+    categories=["theme"],
     description="""
         Sets the root font size (in pixels) for the app, which determines the overall
         scale of text and UI elements. The default base font size is 16.
@@ -1112,8 +1168,9 @@ _create_option(
     visibility="hidden",
 )
 
-_create_option(
-    "theme.showSidebarSeparator",
+_create_theme_options(
+    "showSidebarSeparator",
+    categories=["theme"],
     description="""
         Whether to show a vertical separator between the sidebar and the main content.
     """,
@@ -1275,10 +1332,52 @@ def _update_config_with_toml(raw_toml: str, where_defined: str) -> None:
 
     parsed_config_file = toml.loads(raw_toml)
 
+    def process_section(section_path: str, section_data: dict[str, Any]) -> None:
+        """Recursively process nested sections of the config file.
+
+        Parameters
+        ----------
+        section_path : str
+            The dot-separated path to the current section (e.g., "server" or "theme")
+        section_data : dict[str, Any]
+            The dictionary containing configuration values for this section
+
+        Notes
+        -----
+        TOML's hierarchical structure gets parsed into nested dictionaries.
+        For example:
+            [main]
+            option = "value"
+
+            [main.subsection]
+            another = "value2"
+
+        Will be loaded by the TOML parser as:
+            {
+                "main": {
+                    "option": "value",
+                    "subsection": {
+                        "another": "value2"
+                    }
+                }
+            }
+
+        This function traverses these nested dictionaries and converts them
+        to dot-notation config options.
+        """
+
+        for name, value in section_data.items():
+            option_name = f"{section_path}.{name}"
+            # Process it as a nested config section if it's a custom theme sub-category
+            if name in [CustomThemeCategories.SIDEBAR.value]:
+                process_section(option_name, value)
+            else:
+                # It's a regular config option, set it
+                value = _maybe_read_env_variable(value)
+                _set_option(option_name, value, where_defined)
+
     for section, options in parsed_config_file.items():
-        for name, value in options.items():
-            value = _maybe_read_env_variable(value)
-            _set_option(f"{section}.{name}", value, where_defined)
+        process_section(section, options)
 
 
 def _maybe_read_env_variable(value: Any) -> Any:

streamlit/config_option.py

@@ -152,8 +152,11 @@ class ConfigOption:
             # with a lowercase letter with an optional "_" preceding it.
             # Examples: "_section", "section1"
             r"\_?[a-z][a-zA-Z0-9]*"
+            # Handling zero or additional parts, separated by period
+            # Examples: "_section.subsection", "section1._section2"
+            r"(\.[a-z][a-zA-Z0-9]*)*"
             r")"
-            # Separator between groups
+            # The final period, separating section and name
             r"\."
             # Capture a group called "name"
             r"(?P<name>"

streamlit/config_util.py

@@ -88,7 +88,7 @@ def show_config(
         out.append("")
 
         for key, option in section_options.items():
-            key = option.key.split(".")[1]
+            key = option.key.split(".")[-1]
             description_paragraphs = _clean_paragraphs(option.description or "")
 
             last_paragraph_idx = len(description_paragraphs) - 1